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1  Introduction 

1.1  Scope 

This  manual  tells  you  how  to  install,  build,  and  start  up  the  Binary  HtUast  of  the  Software 
Technology  for  Adaptable  and  Reliable  Systems  (STARS)  Reuse  Library  Framework  (RLF) 
and  its  graphical  user  interface,  the  Graphical  Browser  (GB).  hereafter  referred  to  as  the 
RLF  GB.  The  RLF  system  includes  the  Library -Manager  application.  This  version  of  RLF 
A  can  support  execution  using  Portable  C!ommon  Tools  Environment  (PC’TE)  as  an  underlying 
object  management  system.  If  you  run  the  PGTE  version,  then  certain  guidelines  must  be 
followed  when  installing  and  running  the  software.  PC’TE-specific  information  has  been 
gathered  in  Appendix  B. 

You  should  read  these  instructions  before  you  install  the  RLF  software.  The  reader  is 
expected  to  be  a  system  administrator,  or  fulfill  that  role;  therefore,  familiarity  with  the  UNIX 
C  shell,  UNIX  files  and  directories,  and  basic  X  Window  System  (X)  knowledge  is  assumed. 
Since  this  version  of  RLF  can  support  execution  using  Emeraude’s  implementation  of  PCTE 
as  an  underlying  object  management  system,  if  the  RLF  is  run  with  PCTE,  it  is  assumed 
that  the  user  understands  PCTE  and  the  Emeraude  product,  including  the  ability  to  log  in 
to  the  PCTE  environment,  and  construct  and  run  esh  scripts. 


1.2  Other  Documents 

If  you  want  to  install  the  source  code  release  of  the  RLF,  then  you  should  read  the  H.LF 
Source  Code  Release  Installation  Guide.  The  source  code  releeise  does  not  contain  executable 
programs;  they  must  be  built  from  the  source  code. 

Other  RLF  documents  exist  that  contain  more  detailed  information  about  different  2ispects  of 
the  RLF.  For  information  on  constructing  RLF  libraries,  consult  the  RLF  Modeler's  Manual. 
For  detailed  information  on  RLF  administration  issues,  see  the  RLF  Admviistrator’s  Manual. 
For  help  with  use  of  the  RLF  and  the  RLF  GB,  see  the  RLF  User’s  Manual. 


1.3  Overview  of  Document 

The  RLF  Binary  Release  Installation  Guide  contains  the  following  sections: 


•  Section  2,  Installing  the  Birary  Release  of  the  RLF  Software,  describes  how  to  load 
the  executable  RLF  software  onto  your  system  from  the  distribution  tape  or  from  the 
Internet.  The  procedures  for  configuring  and  installing  the  RLF  binary  release  are 
then  described. 

The  RLF  binary  release  contains  pre-built,  executable  software,  and  does  not  contain 
any  source  code. 
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•  Section  3,  Verifying  the  RLF  Installation,  describes  the  procedures  for  starting  up  the 
RLF  Graphical  Browser  in  order  to  verify  that  the  installation  was  successful. 

1.4  Identification 

This  manual  is  for  the  RLF  Binary  Release,  Version  4.1,  March.  1993.  This  release  runs  on 
SunOS,  version  4.1.1  or  later. 

The  only  other  software  dependency  that  exists  is  the  following: 

•  MIT  X11R4 

^  The  PCTE  version  of  the  RLF  software  depends  on  the  above  software  at  run-time,  plus: 
A  •  Emeraude  PCTE,  v.r2.3 

1.5  Product  Overview  and  Rationale 

Within  a  particular  problem  domain,  applications  tend  to  have  similar  characteristics.  To 
facilitate  reuse  within  a  domain,  it  is  useful  to  analyze  the  domain  to  identify  the  similarities 
and  differences  among  applications,  and  to  record  the  results  of  this  analysis  in  the  form  of 
a  domain  model  and  generic  domain  architecture.  A  crucial  requirement  for  domain-specific 
reuse  libraries  of  the  future  is  that  they  provide  a  means  for  storing  and  accessing  this  domain 
knowledge  to  readily  support  reuse-based  application  development. 

The  RLF  was  designed  specifically  to  meet  this  need.  The  RLF  supports  the  development  and 
evolution  of  comprehensive  domain  models  consisting  of  taxonomic  information  to  describe 
domain  structure  and  rule  bases  to  capture  heuristic  domain  knowledge.  Such  a  domain 
model  is  capable  of  supporting  many  tools  that  impact  all  phases  of  the  software  life  cycle 
and  support  reuse  of  a  broad  spectrum  of  life  cycle  products  beyond  just  source  code. 

The  search  and  retrieval  mechanisms  of  the  RLF  provide  both  novice  and  experienced  users 
effective  reuse  library  access.  The  RLF  provides  several  modes  of  user  interaction  to  sup¬ 
port  different  search  strategies.  The  fundamental  mode  of  operation  relies  on  a  brow'sing 
paradigm,  wherein  users  are  presented  with  a  graphical  representation  of  the  library  domain 
model  and  move  through  the  libraiy  under  their  own  control,  deciding  which  kinds  of  cissets 
to  investigate.  The  RLF  also  provides  an  advisor  mode,  which  gives  users  rule-based  ad¬ 
vice  about  which  cissets  to  investigate  next,  and  a  query  mode  which  allows  users  to  submit 
database-style  queries  about  library  assets. 

The  main  purpose  of  the  RLF  GB  is  to  provide  a  graphical  user  interface  to  the  RLF.  This 
graphical  interface  is  the  primary  user  interface  when  the  RLF  is  used  as  a  domain-specific 
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software  reuse  librar\-  tool.  Another  purpose  of  the  RLF  CJB  is  to  denionstrate  large-scale 
Ada  software  reuse.  The  RLF  GB  itself  reuses  the  RLF  and  RGB  soft  ware  subsystem 
components. 

The  RLF  GB  provides  to  the  user  a  graphical,  point-and-click  interface  to  the  RLF  and  its 
structured  domain  knowledge.  The  graphical  interface  to  the  RLF  has  completely  replaced 
the  textual  interface  of  older  versions  of  the  RLF.  The  Library-Editor  application  has 
become  the  Library-Manager  and  also  has  a  graphical  interface;  the  textual  interface  is  no 
longer  supported.  The  RLF  GB  relies  on  the  X  Window  System  (X)  to  provide  some  of 
its  capabilities,  such  as  windowing,  pull-down  menus,  graphics  display,  and  mouse  control. 
With  these  capabilities  the  RLF  GB  can  graphically  depict  an  RLF  library,  and  the  user  can 
view  and  interact  with  the  library  using  simple  mouse  actions.  The  library  structure  is  also 
referred  to  as  a  domain  model. 

The  RLF  GB  provides  read-only  access  to  the  domain  model;  it  does  not  provide  any  net¬ 
work  creation  or  modification  capabilities.  The  Library-Mamager  application  provides  some 
library  modification  capabilities,  but  is  only  discussed  in  this  manual  in  relation  to  its  in¬ 
stallation.  For  a  detailed  discussion  of  the  Library  Manager,  see  the  RLF  Administrator's 
Manual. 
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1.6  Notation  Used  in  this  Manual 

This  manual  describes  procedures  to  interact  with  the  UNIX  operating  system  through  a  C 
shell  interpreter.  Therefore,  examples  are  given  that  sometimes  use  a  special  notation.  In 
presenting  the  examples,  this  document  uses  the  following  notational  conventions: 


•  typewriter  font 

This  font  represents  information  displayed  by  the  computer.  It  is  also  used  in  code 
examples  and  textual  passages  to  indicate  use  of  the  C  shell  command  language  or 
names  of  UNIX  or  application  programs. 


•  italic  font 

This  font  is  used  in  textual  passages  and  code  examples  to  indicate  user-specified 
parameters  for  program  names  or  command  line  options;  it  is  also  used  to  indicate 
special  terms  or  phrases  used  in  textual  descriptions. 


boxed  typewriter  font 

Boxed  typewriter  text  indicates  information  that  you  type  exactly  as  shown  as  input 
to  the  computer. 


boxed  italic  font 


Boxed  italic  text  indicates  information  that  you  must  supply  and  type  as  input  to 
the  computer. 


•  y. 

The  percent  sign  is  used  to  represent  the  C  shell  prompt. 

•  [Quit] 

This  bold  font,  enclosed  in  square  brackets,  represents  a  graphical  command  button, 
or  menu  option  that  is  available  from  a  graphical  pull-down  menu  or  cascading  menu. 


1.6.1  Notation  Examples 

In  the  following  example  you  would  type  the  text  “source  $H0ME/ .  cshrc”  but  you  would 
not  type  the  percent  sign  which  is  the  C  shell  prompt;  also  note  that  your  C  shell 

prompt  may  appear  differently: 


source  $H0ME/. cshrc 


In  the  next  example  you  would  insert  the  name  of  a  text  editor  of  your  choice,  such  as  vi  or 
emacs,  but  you  would  type  the  filename  “.cshrc”  as  shown: 
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The  following  example  shows  the  use  of  the  square  brackets  to  indicate  a  graphical  command 
button.  These  buttons  are  displayed  by  X  and  must  be  clicked  on  with  a  mouse  to  be 
activated; 


Select  the  [Quit]  button  to  exit  the  RLF  GB. 
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2  Installing  the  Binary  Release  of  the  RLF  Software 

This  section  contains  the  instructions  to  install  the  binary  release  of  the  RLF. 


2.1  Installation  Overview 

The  following  list  summarizes  the  steps  required  to  install  the  Binary  Release  of  the  RLF. 
This  section  is  only  an  overview;  each  installation  step  is  discussed  in  more  detail  in  the 
following  sections. 

1.  Check  installation  requirements: 

•  Hardware  requirements 

•  Memory  requirements  (main  memory,  disk  space,  swap  space) 

•  Software  requirements 

2.  Install  RLF  software  from  magnetic  tape  or  download  from  network,  using  one  of  the 
following  two  procedures: 

•  Load  software  from  tape,  as  follows: 

-  Make  sure  you  have  the  correct  distribution  tape. 

—  Choose  a  tape  drive. 

-  Create  a  directory  to  store  the  software. 

—  Load  the  software  from  tape. 

— or — 

•  Download  software  from  network,  as  follows: 

—  Create  a  directory  to  store  the  downloaded  software. 

-  Download  the  software  from  the  network. 

3.  Extract  and  install  RLF  software  from  the  archive  file: 

•  Extract  the  software  from  the  archive  file. 

•  Configure  and  install  the  software. 

4.  Verify  the  installation. 


2.2  Checking  Installation  Requirements 

Make  sure  your  site  configuration  meets  all  the  requirements  listed  in  this  section  before  you 
try  to  install  and  run  the  RLF  Binary  Release. 
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2.2.1  Hardware  Requirements 

The  RLF  software  requires  the  following  type  of  workstation: 

•  Sun-4  workstation  (SPARCstation) 

The  smallest  Sun  workstation  we  recommend  running  RLF  on  is  as  follows: 

SPARC  IPC  with  16  megabytes  (MB)  of  memory  and  60  MB  of  swap  space 

The  important  factor  in  running  an  RLF  application  is  the  amount  of  physical  memory 
available  along  with  the  amount  of  swap  space  available  (given  that  you  are  running  on  a 
SPARC  chip). 

There  are  many  different  display  devices  (also  known  as  “framebuffers”)  available  for  Sun 
workstations.  The  display  device  for  your  workstation  must  be  supported  by  the  windowing 
system  you  use. 


2.2.2  Memory  Requirements 

To  run  the  RLF  software,  you  must  meet  the  following  memory  requirements: 


•  You  must  have  at  least  8  MB  of  main  memory.  For  improved  performance,  increase 
memory  size — 16  MB  of  main  memory  is  recommended,  and  32  MB  is  preferred. 

•  You  must  have  at  least  40  MB  of  disk  space  to  install  the  RLF  Binary  Release  software. 

•  You  must  have  at  least  60  megabytes  of  swap  space  to  run  the  RLF  software  with 
the  Graphical  Browser.  (It  is  recommended  that  if  you  have  more  than  60  megabytes 
available  to  allocate  to  swap  space  that  you  do  so.  Anywhere  from  60  to  120  megabytes 
of  swap  space  is  recommended.) 

Use  the  df  command  to  check  how  much  disk  space  you  have.  The  “avail”  column  shows 
the  amount  of  free  disk  space  (in  thousands  of  bytes). 


df 


Use  the  pstat  command  to  check  how  much  swap  space  you  have: 


% 


/etc/pstat  -T 


The  second  number  on  the  last  line  of  the  output  is  the  swap  space  (in  thousands  of  bytes). 
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2.2.3  Software  Requirements — Run-Time 

The  RLF  software  depends  on  the  following  software  at  run-time: 

•  This  manual  assumes  a  UNIX  C  shell  interpreter  is  accessible  to  the  user. 

•  The  MIT  X  Window  System,  Release  4 

•  SunOS  Release  4.1.1  or  later 


A  The  PCTE  version  of  the  RLF  software  depends  on  the  above  software  at  run-time,  plus: 
A  •  Emeraude  PCTE,  v.12.3 


To  check  which  version  of  the  operating  system  your  site  is  running,  use  the  head  command 
to  print  out  the  first  line  of  the  message  of  the  day: 


•/. 


head  -1  /etc/motd 


The  RLF  GB  can  be  executed  on  any  workstation  running  X11R4.  This  can  be  the  Sun- 
supplied  implementation  of  X,  OpenWindows,  or  the  X  distribution  from  MIT. 

There  are  a  number  of  window  managers  that  one  may  use  in  an  X  environment.  The 
RLF  GB  has  been  used  successfully  under  the  following  such  window  managers:  mwm  (Motif 
Window  Manager),  twm  (the  official  MIT-distributed  window  manager),  and  the  Visual  User 
Environment  (VUE)  (from  SAIC  or  Hewlett-Packard). 


2.3  Installing  the  RLF  Binary  Release  from  Tape 

This  section  explains  how  to  load  the  RLF  Binary  Release  from  the  distribution  tape. 

To  load  the  RLF  Binary  Release  from  tape,  you  must: 

1.  Make  sure  you  have  the  correct  distribution  tape  (or  tapes). 

2.  Choose  a  tape  drive  (either  the  one  on  your  local  machine  or  one  on  another  machine 
on  your  network). 

3.  Extract  the  RLF  software  from  the  tape,  by  following  the  instructions  described  below. 
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2.3.1  The  RLF  Distribution  Tape 

The  RLF  software  is  distributed  on  tape  in  tar  format.  There  are  different  versions  of  the 
distribution  tape,  depending  on  the  type  of  release  being  installed:  binary  or  source  code. 

The  machine  architecture  supported  is  Sun-4  (SPARC).  This  is  the  only  architecture  sup¬ 
ported  at  this  time.  The  Sun-3  architecture  is  no  longer  supported. 

You  can  use  the  arch  command  to  verify  what  type  of  machine  architecture  you  have: 


y. 


arch 


and  the  output  should  be: 


sun4 


2.3.2  Choosing  a  Tape  Drive 

For  tape  installation,  this  guide  discusses  local  installation  only,  however,  you  can  perform 
installation  from  tape  in  two  ways: 


Locally  Local  installation  occurs  when  you  use  the  tape  drive  of  the  machine  on  which  the 
software  is  to  reside. 

Remotely  Remote  installation  occurs  when  you  use  the  tape  drive  of  a  machine  other  than 
the  one  on  which  the  software  is  to  reside;  the  machine  whose  tape  drive  you  use  (the 
remote  machine)  must  have  a  network  connection  to  the  machine  on  which  the  software 
is  to  reside  (the  local  machine).  In  this  case,  you  must  be  able  to  access  the  remote 
machine  by  using  the  rsh  command. 


2.3.3  Extracting  the  RLF  Binary  Release  from  the  Tape 

To  extract  the  RLF  software  from  the  tape,  use  the  tar  command.  To  successfully  complete 
the  extraction  procedure,  you  must  have  the  following  information  available: 


1.  The  pathname  of  the  directory  where  you  plan  to  install  the  RLF  software  (also,  make 
sure  you  have  write  access  to  this  directory).  This  directory  will  be  referred  to  as 
the  RLF  “home”  directory,  and  its  value  will  be  denoted  by  the  environment  variable 
RLFHOME  in  the  following  examples,  or  $RLFH0ME  when  referencing  the  variable. 

2.  The  name  of  the  tape  device  (e.g.,  /dev/rstl). 
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2.3.4  Summary  of  Binary  Release  Installation  Steps 

1.  Extract  the  files  on  the  tape  into  the  RLE  home  directory. 


y. 


setenv  RLFHOME  directory.name 


•/.  cd  $RLFH0ME 


X  tar  xvf  tape-device 


2.  Run  the  Install_RLF_bin  script. 


X  Install_RLF_bin 


— or  for  PCTE: 


Install_RLF_pcte_bin 


•  Run  the  installation  script  interactively,  or 

•  Edit  the  configuration  file  and  run  the  installation  script  in  batch  mode 


The  RLE  installation  script  is  described  in  further  detail  on  Section  2.6. 


2.4  Obtaining  the  RLF  Binary  Release  via  Anonymous  FTP 

This  section  explains  how  to  obtain  the  RLF  Binary  Release  via  anonymous  FTP  over  the 
Internet,  using  the  UNIX  ftp  program.  (FTP  is  an  acronym  that  stands  for  the  “File  Tranfer 
Protocol.”  The  UNIX  program  ftp  is  an  implementation  of  the  FTP  protocol.)  Once  the 
necessary  archive  files  have  been  transferred  to  your  local  host,  you  must  extract  the  RLF 
files  from  the  archive.  This  section  also  provides  instructions  for  this  operation. 

To  access  the  RLF  software  via  anonymous  FTP,  you  must: 

1 .  Choose  a  local  directory  where  the  RLF  archive  file  will  be  downloaded  to. 

2.  Establish  an  anonymous  FTP  connection  over  the  Internet. 

3.  Transfer  the  appropriate  files. 

4.  Extract  the  RLF  software  from  the  archive  file,  by  following  the  instructions  described 
below. 


First  choose  a  directory  where  the  RLF  archive  files  will  be  stored.  Then  set  your  current 
working  directory  to  that  directory. 

For  example: 
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%  cd  directory.name 

Now  establish  a  connection  to  the  STARS  anonymous  FTP  host.  The  Internet  name  of  this 
host  is:  falcon.stars.rosslyn.paraLmaLX.com.  To  establish  an  FTP  connection,  issue  the 
ftp  command  with  a  host  name  as  an  argument.  For  example: 

y,  ftp  falcon.staLrs.rosslyn.paramaLX.com 


The  following  is  a  sample  FTP  session.  The  text  you  must  type  is  enclosed  in  boxes.  The 
FTP  prompt  is  indicated  by  the  string  “ftp>”. 

Connected  to  falcon. stars. rosslyn.paramax. com. 

220  falcon  FTP  server  (Version  5.107  )  ready. 

Name  (f alcon. stars. rosslyn.paramax. com: username) :  anonymous 
331  Guest  login  ok,  send  ident  as  password. 

Password:  your.network.address 

230  Guest  login  ok.  access  restrictions  apply. 

ftp>  cd  pub/RLF 

250  CWD  commaLnd  successful. 

ftp>  I  Is  -al 

200  PORT  command  successful. 

150  Opening  ASCII  mode  data  connection  for  /bin/ls. 
total  5706 

drwxr-xr-x  2  103  512  Jun  29  15:39  . 
drwxrwxrwx  10  ftp  1024  Aug  14  19:00  .. 

-rw-r — r —  1  116  491040  Nov  30  1992  RLF-4.  l_bin.tar.Z.split-aa 

-rw-r— r—  1  116  488439  Nov  30  1992  RLF_4. l_bin.tar .Z.split-ab 

-rw-r— r—  1  116  479725  Nov  30  1992  RLF_4.  l_bin.tar.Z.split-ac 

-rw-r — r —  1  116  495984  Nov  30  1992  RLF_4.  l_bin. tar. Z. split-ad 

-rw-r— r—  1  116  400538  Nov  30  1992  RLF_4.1_bin.tar.Z.split-ae 

-rw-r — r —  1  116  461326  Nov  30  1992  RLF_4.1_bin.tar.Z.split-af 

-rw-r— r—  1  116  507647  Nov  30  1992  RLF_4.1_bin.tar.Z.split-ag 

226  Transfer  complete, 
remote:  -al 

1006  bytes  received  in  0.23  seconds  (4.2  Kbytes/s) 

ftp>  binary 

200  Type  set  to  I. 

ftp>  I  mget  RLF_4 .  l_bin* 

mget  RLF_4.  l_bin.tar  .Z.split-aa? 

200  PORT  command  successful . 

150  Opening  ASCII  mode  data  connection  for  RLF_4.  l_bin.  tar  .Z.split-aa 
(491040  bytes) 


-rw-r — r — 
-rw-r — r — 
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226  Transfer  complete. 

local:  RLF_4.  l-bin.tar .Z. split-aa  remote:  RLF_4.  l_bin.tar.Z.split-aa 
493040  bytes  received  in  75  seconds  (6.4  Kbytes/s) 
mget  RLF_4.1_bin.tar.Z.split-ab? 

200  PORT  command  successful. 

150  Opening  ASCII  mode  data  connection  for  RLF_4.  l_bin.tar.Z.split-ab 
(488439  bytes) 

226  Treoisfer  complete. 

local:  RLF_4.  l_bin.tar.Z.split-ab  remote:  RLF_4.  l_bin.tar  .Z.  split-ab 
490439  bytes  received  in  75  seconds  (6.4  Kbytes/s) 
mget  RLF_4.  l_bin.tar.Z.split-ac? 

200  PORT  command  successful. 

150  Opening  ASCII  mode  data  connection  for  RLF_4.  l_bin.tar  .Z.split-ac 
(479725  bytes) 


(Answer  yes  (y)  to  all  the  mget  prompts.) 


ftp>  quit 


221  Goodbye, 


All  the  RLF  archive  files  should  now  have  been  transferred  to  your  local  directory.  The  next 
section  describes  the  procedure  to  extract  the  RLF  software  from  the  archive  files. 


2.5  Extracting  the  RLF  Binary  Release  from  an  Archive  File 

The  RLF  archive  files  residing  on  the  anonymous  FTP  host  are  in  UNIX  tar  format  [tar 
stands  for  tape  archive,  but  a  tape  archive  can  also  exist  on  a  disk).  In  addition,  the  tar 
files  have  been  split  and  compressed.  The  UNIX  split  command  divides  a  large  file  into 
many  smaller  files.  The  UNIX  compress  command  makes  files  smaller  in  size  through  the 
use  of  a  file  compression  algorithm. 

The  intent  of  the  extraction  process  is  essentially  to  “undo”  what  the  tar,  compress,  and 
split  programs  have  done  to  the  RLF  software.  Therefore,  what  needs  to  be  done  is  to 
concatenate  all  the  split  files  back  together,  uncompress  them,  and  extract  the  RLF  software 
files  from  the  resulting  archive. 

When  you  extract  the  RLF  software  from  the  archive,  the  tar  command  will  create  the 
necessary  directory  hierarchy  automatically,  starting  at  the  current  directory.  Therefore, 
before  you  start  the  extraction  process,  ensure  that  you  are  in  the  desired  directory. 

To  extract  the  RLF  software  from  the  archive  files,  issue  the  following  command: 
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zcat  RLF-4.  l_bin. tar. Z. split*  |  tar  xvf  - 


The  zcat  command  uncompresses  and  concatenates  the  split  files  together,  and  the  results 
are  then  piped  (the  vertical  bar  “|”  represents  a  UNIX  pipe)  to  the  tar  command  which 
extracts  the  files  from  the  archive.  The  dash  at  the  end  of  the  tar  command  is 

important — it  tells  the  tar  program  to  read  its  input  from  the  pipe  instead  of  from  a  file,  so 
be  sure  to  include  it  in  your  command  line. 

When  this  command  is  complete,  you  should  have  a  complete  directory  structure,  starting 
at  your  current  working  directory,  of  all  the  RLF  executable  software,  and  documentation. 
The  RLF  installation  script,  InstallJlLF_bin,  should  now  reside  in  this  directory.  (The 
PCTE  installation  script  is  named  InstallJlLF_pcte_bin). 

The  next  step  is  to  run  the  RLF  Binary  Release  installation  script.  This  script  is  described 
in  further  detail  in  the  following  section. 


2.6  Configuring  and  Installing  the  RLF  Binary  Release 

For  the  Binary  Release,  the  RLF  installation  script  performs  the  following  tasks: 


•  ensures  configuration  variables  are  properly  set 

•  installs  sample  RLF  libraries 

•  copies  the  RLF_Browser  file  to  /usr/lib/Xll/app-defaults 

•  creates  the  bitmaps  directory  in  /usr/lib/Xll/app-def aults/bitmaps  and  copies 
the  bitmap  files  into  that  directory 


There  are  two  ways  to  run  the  installation  script:  interactively,  or  in  batch  mode.  The 
interactive  mode  prompts  you  for  all  the  necessary  information.  In  batch  mode,  you  edit 
the  file  Install_Rlf  .var  and  supply  all  the  necessary  information  by  setting  environment 
variables  appropriately. 

Since  the  Install_RLF_bin  script  copies  files  into  system  directories,  you  must  be  “root”  or 
have  root  privileges  to  successfully  run  the  script.  To  complete  the  installation  of  the  RLF 
software,  log  in  as  “root”  if  you’re  not  already,  and  invoke  the  Install_RLF_bin  script: 


*/.  [iul 

Password: 


rooLpassword 


%  \  Install-RLF.bin 
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—or  for  PCTE: 

'/,  Install_RLF_pcte_bin 

The  installation  script  assumes  the  existence  of  the  directory: 

/usr/lib/Xll 

and 

/usr/lib/Xll/app-defaults 

for  installing  X-related  data  files.  However,  if  it  is  not  feasible  or  desirable  to  install  the 
“RLF -Browser”  file  or  bitmap  files  in  the  above  directories  at  your  site,  then  consult  Ap¬ 
pendix  A,  “Customization,”  of  this  document  for  alternative  approaches. 

2.6.1  Running  the  Installation  Script  Interactively 

If  you  choose  to  run  the  installation  script  interactively,  you  will  be  prompted  for  all  the 
necessary  site-specific  information.  A  sample  run  of  the  installation  script  is  given  below. 

This  example  assumes  you  have  set  the  environment  variable  RLFHOME  to  an  appropriate 
value  before  issuing  the  following  commands. 

•/. 

•/. 

—or  for  PCTE: 

•/. 


RLF  4.1  Installation  Script 
Binary  Release 
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+ 


+ 


You  must  choose  one  of  the  following  installation  options: 


1.)  Interactive  installation 

*  You  are  prompted  for  all  necessary 

configuration  values  (i.e.,  pathnames). 


2.)  Edit  the  file  that  contains  the  configuration  values 

♦  You  edit  the  file  "Install.Rlf . var"  cind 
set  the  configuration  values  appropriately 
for  your  site. 


3.)  EXIT  this  script. 


(If  you  do  not  edit  the  "Install.Rlf .var"  file,  or  specify 
invalid  values,  you  will  be  prompted  for  the  configuration 
values  anyway.) 


Which  installation  option  do  you  prefer? 


Please  enter  1,  2,  or  3  >  0 


You  chose:  1 

- - - 

I  Executing  interactive  installation  script.  I 
+ - - - - 

Define  the  site-dependent  environment  variables. 


NOTE:  If  you  have  already  set  the  RLFHOME  variable,  then  the  fol- 
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lowing  section  of  the  installation  script  will  not  be  executed. 


Specify  path  to  top-level  RLFHOME  directory 


Examples : 

/mybase/RLF 
/af s/myhome/see/rlf 
/usr/tools/rlf 
etc . 


RLFHOME  = 


/afs/rnyhome/see/rlf 


NOTE:  If  you  have  already  set  the  RLFHOME  variable,  then  the  above 
section  of  the  installation  script  will  not  be  executed. 

RLFHOME  *  /afs/myhome/see/rlf 
RLFBIN  =  /afs/myhome/see/rlf/bin 

APPDEFAULTS  =  /usr/lib/Xll/app-defaults 

Moving  the  RLF  GB  resource  file  (RLF.Browser)  to  /usr/lib/Xll/app-defaults 

Moving  the  RLF  GB  bitmap  files  to  /usr/lib/Xll/app-defaults/bitmaps 

Installation  Complete 


The  installation  of  the  RLF  system  is  now  complete.  By  issuing  an  Is  command,  you  should 
be  able  to  determine  that  the  bin  subdirectory  of  the  RLFHOME  directory  contains  the  fol¬ 
lowing  executable  programs: 


•/.  Is  $RLFHOME/bin 


.rlfrc 

Graphical_Browser 
Library -Manager 
Lmdl 
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RLF_Browser 

RLF-GB 

Rbdl 

Sndl_to_Lmdl 

bitmaps  (a  directory) 

less 

view.stp .  csh 
xloadimage 


2.6.2  Running  the  Installation  Script  in  Batch  Mode 

To  run  the  installation  script  in  batch  mode,  you  must  first  edit  the  file  $RLFHOME/code/Install_Rlf  .  v 
and  edit  the  following  section  of  that  file;  there  is  one  environment  variable  that  must  be  set 
appropriately  for  your  site: 


#setenv  RLFHQME  /af s/myhome/test/rlf_4. 1 


Note  that  all  the  above  line  is  commented  out  (the  pound-sign  (#)  is  the  C  shell  symbol  that 
indicates  the  rest  of  the  line  is  to  be  ignored).  You  must  “un-comment”  out  this  line  (i.e., 
delete  the  pound-sign)  and  supply  the  appropriate  values  for  all  the  given  variables. 

If  you  supply  erroneous  values  for  any  of  the  variables,  then  the  script  will  notify  you  during 
its  execution  because  it  checks  the  validity  of  all  supplied  variables.  The  script  will  prompt 
you  for  any  variables  that  are  not  set  or  that  are  set  improperly. 

The  type  of  data  that  must  be  supplied  for  each  variable  is  described  in  the  following  list: 


RLFHOME  Pathname 

Supply  a  pathname  where  the  entire  RLF  directory  hierarchy  will  reside. 


The  following  environment  variables  are  given  the  default  values  shown  below.  If  these  values 
are  invalid  for  your  site,  then  you  must  supply  valid  values  or  else  the  build  will  fail: 

APPDEFAULTS  /usr/lib/Xll/app-def aults 

The  standard  pathname  of  the  XU  directory  for  system-wide  application  defaults  files. 


2.6.3  On-Line  “man”  Pages  Installation  Procedures 

This  se<'tion  describes  the  procedures  for  installing  and  using  the  RLF  “man”  pages  (an 
abbreviation  of  “manual”  pages).  The  UNIX  system  maintains  the  convention  of  providing 
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on-line  reference  manual  pages  for  programs.  Using  the  UNIX  man  command,  a  user  may 
display  information  from  any  “man”  pages  that  have  been  installed  on  the  system  and  that 
are  in  the  “man”  page  searcl  .h. 

The  “man”  page  sources  are  conventionally  located  in  the  /usr/man  directory.  Typically 
there  are  subdirectories  in  /usr/man  such  as  maml,  man2,  m«in3,  etc.,  that  refer  to  major 
sections  of  the  UNIX  reference  manuals,  and  possibly  additional  subdirectories  such  as  manl 
that  have  been  tailored  for  your  site.  For  example,  mcinl  refers  to  the  local  “man”  pages. 

The  procedures  described  below  assume  that  the  RLF  “man”  pages  have  been  installed  in 
the  $RLFHOME/mein/manl  subdirectory,  and  that  they  will  remain  in  that  location.  If  desired, 
you  may  copy  or  move  the  $RLFHOME/man/manl  directory  to  the  standard  /usr/man/manl 
directory  or  some  other  directory  where  “man”  pages  are  located  at  your  site. 

Procedure  to  install  RLF  “man”  pages  in  the  $RLFHOME/man  directory: 

Create  preformatted  versions  of  the  RLF  “man”  pages  from  the  input  files  residing  in 
$RLFHOME/man/manl  and  place  them  into  the  newly  created  directory  $RLFHOME/maii/catl, 
and  then  create  a  small  “whatis”  database  file  in  $RLFHOME/maii: 


/usr/etc/catman  -M  $RLFHOME/man  1 


Edit  your  $H0ME/ .  login  or  $H0ME/ .  cshrc  file,  adding  the  line: 


setenv  MANPATH  "/usr/man: $RLFHOME/man" 


Note  that  you  may  have  to  alter  the  above  MANPATH  environment  variable  specification 
slightly  if  you  are  already  setting  MANPATH,  such  as  to  include  local  man  pages: 


setenv  MANPATH  "/usr/man:/usr/local/man:$RLFHOME/man" 


To  activate  the  MANPATH  environment  variable,  either  source  the  .login  (or  .cshrc)  file 
that  you  edited,  or  log  out  and  then  log  back  in: 


*/,  source  $H0ME/. login  — or —  7,  source  $H0ME/. cshrc 


2.6.4  User-Specific  Installation  Procedures 

These  are  the  items  that  specific  users  may  want  to  consider: 
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•  .rlfrc 

The  .rlfrc  file  is  the  RLF  initialization  file. 

•  RLF-Browser 

The  RLF .Browser  file  is  the  X  application  resource  file. 

•  MANPATH 

The  MANPATH  environment  variable. 


The  RLF  looks  for  the  .rlfrc  file  in  the  user’s  home  directory  ($H0ME)  or  the  current  working 
directory.  If  the  .rlfrc  file  is  found  there,  then  the  RLF  reads  in  initialization  data  from 
the  file.  Command-line  options  override  any  settings  in  the  .  rlfrc  file. 

The  RLF  browser  file  is  used  by  the  X  Window  System  to  configure  the  application  according 
to  user-  or  site-specific  parameters.  The  user  may  place  a  copy  of  the  RLF .Browser  file 
into  his  or  her  home  directory  ($H0ME)  and  then  modify  it  to  suit  individual  tastes.  A 
RLFJrowser  file  in  the  user’s  home  directory  will  automatically  have  higher  precedence 
than  the  RLF.Browser  file  in  /usr/lib/Xll/app-defaults.  Alternatively,  the  user  may 
place  the  RLF  browser  file  in  any  directory  of  their  choice,  and  then  set  the  XAPPLRESDIR 
environment  variable  to  that  pathname,  as  in  the  following  example: 


y,  cp  /usr/lib/Xll/app-defaults/RLF.Browser  /home/mydir/tools/rlf 
%  setenv  XAPPLRESDIR  /home/mydir/tools/rlf 


The  above  example  assumes  the  user  is  able  to  place  a  copy  of  the  RLF.Browser  file  into  the 
directory  /home/mydir/tools/rlf 

Also,  users  may  want  to  edit  their  $H0ME/ . login  or  $HOME/.cshrc  file,  adding  the  line: 


setenv  MANPATH  "/usr/man:$RLFHOME/meLn" 


so  that  they  may  access  the  RLF  “man”  pages. 
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3  Verifying  the  RLF  Installation 

This  section  describes  procedures  to  verify  that  the  RLF  installation  is  correct.  The  in¬ 
stallation  of  the  RLF  software  is  considered  to  be  correct  if  the  RLF  GB  can  be  invoked 
successfully  and  an  RLF  library  browsed. 


3.1  Initial  Setup  Procedures 

This  manual  assumes  that  you  know  how  to  start  up  the  X  Window  System  on  your  work¬ 
station.  For  more  detailed  information  on  starting  and  customizing  X,  see  the  X  document 
listed  in  Appendix  D,  “References.” 

If  the  RLF  GB  has  been  built,  then  there  will  be  an  executable  file  named 
GraphicalJBrowser  available  for  execution.  Place  the  pathname  where  the 
Graphical-Browser  file  resides  into  your  command  search  path.  This  is  accomplished  by 
modifying  the  value  of  the  C  shell  path  variable,  either  temporarily  or  permanently. 

You  can  temporarily  place  the  pathname  of  the  GraphicaUrowser  executable  into  your 
command  search  path  by  modifying  the  C  shell  path  variable.  This  can  be  done  by  issuing 
the  following  commands  at  your  C  shell  prompt: 


JC  setenv  RLFHOME  rlf.pathname 


*/,  set  path  =  (  $RLFHOME/imix/bin  $path  ) 


— or 


for  PCTE: 


%  set  path  =  (  $RLFHOME/pcte/bin  $path  ) 


This  will  add  $RLFHOME/unix/bin  or  $RLFHOME/pct e/bin  to  your  current  command  search 
path,  where  rlf.pathname  is  a  pathname  you  supply.  However,  when  your  current  shell  is 
exited,  this  modification  will  be  lost. 

You  can  permanently  place  the  pathname  of  the  Graphical-Browser  executable  into  your 
command  search  path  by  editing  the  C  shell  initialization  file  (named  .  cshrc)  in  your  home 
directory  and  inserting  the  set  path  command,  as  in  the  following: 


*/,  edit  $H0ME/ .  cshrc 


insert  the  following  line  in  the  .  cshrc  file: 
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set  path  =  (  $RLFHOME/unix/bin  $path  ) 


—or  for  PCTE: 


set  path  =  (  $RLFHOME/pct e/bin  $path  ) 


after  any  existing  set  path  commands,  where  $path  is  the  shell  variable  that  contains 
your  current  command  search  path,  and  $RLFH0ME  is  the  previously  set  environment  vari¬ 
able  that  specifies  the  RLF  home  directory.  The  unix/bin  or  pcte/bin  directory  directly 
beneath  $RLFH0NE  contains  the  Graphical-Browser  executable.  Alternatively,  you  can  add 
$RLFHOME/unix/binor  pcte/bin  to  any  set  path  statement  that  may  already  exist  in  your 
.cshrc  file.  Since  the  C  shell  reads  the  .cshrc  file  every  time  it  is  started,  these  variable 
settings  are  effectively  permanent  until  you  edit  the  .  cshrc  again. 

There  are  two  environment  variables  that  must  be  set  before  the  RLF  GB  can  be  run 
successfully.  They  are  as  follows: 

•  DISPLAY 

•  RLF.LIBRARIES 


You  can  edit  the  .cshrc  file  so  that  these  variables  are  automatically  set  every  time  you 
invoke  a  new  C  shell. 


3.1.1  The  DISPLAY  Environment  Variable 

The  DISPLAY  environment  variable  is  used  by  X  to  determine  the  host  where  your  X  server 
is  running,  as  well  as  the  number  of  the  display  to  be  used  on  that  host.  To  have  this 
environment  variable  set  automatically  each  time  you  log  in,  insert  the  following  line  into 
your  .  cshrc  file: 


edit  $H0ME/ .  cshrc 


setenv  DISPLAY  hostnameiO 


where  the  hostname  is  the  name  of  your  computer  system  as  it  is  known  to  your  network,  and 
“:0”  refers  to  the  first  display  screen  of  your  system  (most  conventional  computer  systems 
are  of  the  one-display  type,  but  X  allows  applications  to  run  on  multi-display  systems).  You 
can  obtain  your  host  name,  if  you  do  not  already  know  it,  by  issuing  the  UNIX  command 
hostname. 
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For  example,  if  you  issued  the  hostnzune  command,  as  follows: 


y. 


hostname 


and  you  received  the  following  output: 


spare 10 


then  you  would  set  your  DISPLAY  environment  variable  as  follows: 


setenv  DISPLAY  sparclOrO 


3.1.2  The  RLFJLIBRARIES  Environment  Variable 

The  RLFJLIBRARIES  environment  variable  is  used  by  the  RLF  to  determine  the  location 
of  the  RLF  libraries  to  be  read.  An  RLF  library  must  be  created  before  the  RLF  GB  can  be 
used  to  browse  that  library.  However,  the  UNIX  Binary  Release  of  the  RLF  v.4.1  contains  pre¬ 
translated  sample  libraries  that  are  ready  to  browse  in  the  $RLFHOME/Libraries  directory. 
(The  PCTE  release  does  not  contain  pre-translated  libraries — see  Appendix  B  for  details.) 
The  pre-translated  sample  libraries  that  are  provided  are  as  follows: 


•  Demo  Actions 

•  Sort  and  Search  Algorithms 


The  procedures  to  create  the  other  RLF  sample  libraries  that  are  provided  with  the  release 
in  their  source  form  are  explained  in  detail  in  the  RLF  Modeler’s  Manual,  listed  in  Ap¬ 
pendix  D,  “References.”  However,  a  brief  description  of  these  procedures  is  also  provided  in 
this  document  for  the  purpose  of  completely  verifying  the  installation.  See  Section  3.2.2  for 
a  description  of  library  model  specification  translation  procedures. 

To  set  the  RLF_LIBRARIES  environment  variable  to  the  location  of  the  sample  RLF  libraries 
provided  with  this  release,  issue  the  following  command: 


setenv  RLF-LIBRARIES  $RLFHOME/Libraries 


To  have  the  RLF_LIBRARIES  environment  variable  set  automatically  each  time  you  log  in, 
insert  the  following  line  into  your  .eshre  file: 
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setenv  RLF_LIBRARIES  rlfJibrary-pathname 


where  rlfJibrary.pathname  is  the  pathname  to  a  directory  that  contains  at  least  one  previ¬ 
ously  created  RLF  library. 

The  source  command  is  a  valuable  tool  for  working  in  your  current  shell  environment.  When 
you  execute  the  source  command,  your  C  shell  reads  and  executes  the  commands  in  the 
specified  file.  Since  no  new  subshell  is  created,  you  can  use  source  to  modify  your  current 
environment.  Therefore,  after  editing  your  .cshrcfile,  you  can  then  “source”  it  so  that  the 
new  environment  variables  will  be  read  by  your  current  shell.  This  has  an  effect  similar  to 
exiting  your  current  C  shell  and  starting  a  new  C  shell.  To  “source”  your  .cshrc  file,  type 
the  following  command: 


•/. 


source  $H0ME/. cshrc 


where  the  UNIX  environment  variable  $H0ME  is  replaced  by  the  C  shell  with  the  path  to  your 
home  directory. 

If  you  need  more  information  about  setting  up  your  X  environment,  consult  the  X  documen¬ 
tation  listed  in  Section  D.  Experienced  users  may  wish  to  refer  to  Appendix  A,  “Customiza¬ 
tion.” 


3.2  Invoking  the  RLF  GB 

After  the  setup  procedures  have  been  completed,  the  RLF  GB  can  then  be  started.  A  C 
shell  script  is  provided  for  this  purpose,  or,  the  Graphical_Browser  can  be  invoked  directly. 
The  C  shell  is  provided  to  check  the  values  of  the  environment  variables  and  the  status  of 
files  that  the  RLF  GB  reads  during  execution.  The  RLF  GB  can  be  invoked  without  the 
use  of  this  startup  script;  it  is  entirely  optional.  The  RLF  GB  startup  script  is  provided 
as  a  convenience  to  inexperienced  RLF  users  in  an  attempt  to  automate  some  of  the  status 
checking  that  would  be  performed  in  a  trouble-shooting  session. 

The  startup  script  is  named  RLF_GB.  To  invoke  the  RLF  GB,  execute  the  RLF.GB  script  by 
typing  its  name  at  the  C  shell  prompt  and  pressing  the  Return  key: 


RLF.GB 


After  invoking  the  RLF  GB  you  should  see  the  Main  Menu  appear  in  a  new  window  (see 
Figure  1).  Operating  procedures  for  the  RLF  GB  are  explained  in  further  detail  in  the 
following  sections. 

To  invoke  the  RLF  GB  directly,  without  using  the  RLF  GB  startup  script,  type  the  name 
of  the  program  on  the  command  line: 
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RLF  Graphical  Browser  v.4.1 

Main  Menu 


Select  a  Library  Quit 


Figure  1:  The  Main  Menu 


BrowSrvTl^^lB 

Main  Menu 

Select  a  Library  |  QMit 

Ada  Benchmarks 

Ada/Xt 

Anti-Sub  Warfare 

ASSET 

Astronomy 

C3I 

CARDS 

Mammals 

Satellite  Software 

Software  Components 

Sort  and  Search 

Figure  2:  A  Sample  Select  a  Library  Menu 


Graphical-Browser 


As  with  the  startup  script,  after  invoking  the  RLF  GB  you  should  see  the  Main  Menu  appear 
in  a  new  window. 


3.2.1  Browsing  an  RLF  Library 

The  final  verification  that  the  browser  portion  of  the  RLF  installation  was  successful  is 
achieved  when  you  can  browse  an  RLF  library.  You  can  select  a  library  to  browse  by 
clicking  the  mouse  pointer  on  the  Select  a  Library  option  of  the  Main  Menu.  This  will 
invoke  a  pull-down  menu,  similar  to  the  one  shown  in  Figure  2. 

You  can  select  a  library  to  browse  by  positioning  the  screen  pointer  over  a  library  name  and 
clicking  the  first  or  second  (usually  the  left  or  middle)  mouse  button. 
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A  pull-down  menu,  such  as  the  Select  a  Library  menu,  will  stay  posted  on  the  screen  after 
it  is  invoked  with  a  mouse  click.  You  can  then  select  one  of  the  options  available  in  the 
menu  by  moving  the  pointer  over  the  desired  option  and  clicking  the  mouse  on  that  button. 
For  now,  choose  the  library  named,  “Sort  and  Search”  by  placing  the  pointer  inside  the  box 
labeled  “Sort  and  Search”  and  clicking  the  first  or  second  mouse  button. 

After  you  select  a  particular  library,  the  RLF  GB  displays  some  informational  statements 
regarding  its  processing  status  in  the  original  window  from  which  the  application  was  invoked. 
These  statements  reflect  the  progress  of  the  RLF  GB’.s  internal  processing  and  can  be  safely 
ignored.  They  are  displayed  because  large  RLF  libraries  that  contain  hundreds  of  concepts 
can  take  a  minute  or  more  to  process;  therefore,  they  indicate  that  the  program  is  working 
properly.  If  the  RLF  GB  does  encounter  a  problem  with  its  input  or  output  processing,  an 
exception  will  be  raised  and  an  error  message  will  be  displayed.  A  list  of  error  messages  and 
a  description  of  their  possible  causes  is  given  in  an  appendix  of  the  RLF  User’s  Manual. 

The  status  information  appears  similar  to  the  following: 


Welcome  to  the  RLF  Graphical  Browser. 
Version  4.1 

Copyright  1992,  1993  Paramax  Systems  Corp. 

Main  browser  loop . . . 


Getting  the  root  node  of  the  RLF 
Loading  the  current  state  of  the 
Creating  the  graphical  browser’s 


network . 

RLF  network, 
graph  structures . 


This  graph  contains  79  nodes. 


Creating  a  full  view. 
Laying  out  static  views. 


After  an  RLF  library  is  selected,  the  RLF  GB  creates  a  graphical  depiction  of  the  library 
in  a  new  window,  called  a  “view,”  or  “graph  display  window.”  Note  that  by  displaying  an 
RLF  library,  the  Main  Menu  window  is  expanded.  Therefore,  there  is  still  only  one  RLF  GB 
window  being  displayed  at  this  point. 

The  RLF  GB  graph  display  window  should  look  similar  to  Figure  3. 
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Figure  3:  The  RLF  GB  Graph  Display  Window 


If  your  display  looks  similar  to  Figure  3,  then  the  installation  was  successful.  If  your  display 
does  not  look  similar  to  Figure  3,  it  may  be  due  to  configuration  problems  such  as  the 
bitmap  files  not  being  found,  or  inappropriate  font  names  for  your  site.  Or  the  problem  may 
be  something  as  simple  as  an  inappropriate  setting  for  an  environment  variable.  The  first 
item  to  check  is  to  ensure  that  all  environment  variables  have  valid  settings.  The  second  item 
to  check  is  error  messages — see  if  the  RLF  GB  application  reported  any  processing  errors. 
Look  in  the  window  from  which  you  invoked  the  RLF  GB.  Most  error  messages  are  reported 
on  “standard  out”  and  so  would  be  found  there.  If  there  are  any  error  messages  reported, 
check  the  appendix  in  the  RLF  User's  Manual  to  see  if  the  error  message  is  discussed  there. 
If  it  is,  then  follow  the  provided  suggestions  for  solving  the  problem.  If  the  error  message  is 
not  listed  in  the  RLF  User’s  Manual,  and  you  cannot  determine  the  cause  of  the  problem, 
then  report  the  problem  to  the  development  staff.  See  Appendix  C  for  problem  reporting 
procedures. 

3.2.2  Translating  RLF  Sample  Libraries 

The  final  verification  that  the  RLF  installation  was  successful  is  to  run  the  Library  Model 
Definition  Language  (LMDL)  and  Rule  Base  Definition  Language  (RBDL)  translators  on  the 
sample  library  model  specifications  and  translate  them  into  browsable  RLF  libraries.  The 
RLF  Modeler’s  Manual  explains  this  process  in  greater  detail,  but  a  brief  overview  is  given 
here. 
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This  release  of  the  RLF  contains  sample  library  model  specifications.  These  specifications 
can  be  found  in  the  models  subdirectory  of  the  RLFHOME  directory.  The  sample  models 
contained  in  this  release  include  the  following; 


•  Ada/Xt  (the  STARS  Ada  X  bindings) 

•  Anti-Submarine  Warfare  (ASW) 

•  Common  Data  Model 

•  Software  Technology 

•  Window  Manager  Move  Domain 

•  the  LMDL  Action  Submodel 

In  the  models  subdirectory,  each  model  resides  in  its  own  subdirectory.  For  example,  the 
Window  Manager  Move  Domain  model  resides  in  the  vindov-meoiager  subdirectory.  Within 
these  model  subdirectories,  C  shell  scripts  are  provided  that  translate  the  given  library  model 
specification  into  a  browsable  library.  These  scripts  are  named  Build Jibrary.name .  csh, 
where  library.name  is  variable,  depending  on  the  particular  model  subdirectory.  To  run  a 
library  build  script,  type  its  name  on  the  command  line,  as  in  the  following  example: 


•/. 


Build_Window_Manager-Lib .  csh 


The  script  then  proceeds  to  run  the  LMDL  translator  on  the  LMDL  spec,  and  the  RBDL 
translator  on  the  RBDL  specs  (if  any  RBDL  specs  exist).  The  LMDL  and  RBDL  translators 
report  the  progress  of  the  translation  with  status  output  statements.  A  sample  output  is 
given  below; 


Creating  required  sub-directories 


Initializing  text  files 


Building  LMDL  Network  from  move.domain.lmdl 


Parsing  LMDL  specification. 

Penrsing  completed  successfully. 

Begitming  parse  tree  attribute  evaluation. 
Completed  parse  tree  attribute  evaluation. 
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Creating  library  model  ‘‘Window  Managers  Move  Domain’’. 

Building  libreory  model  in  memory. 

Adding  category  ‘‘Action  Definition’’ 

Using  ‘ ‘move_domain_ concept ’ ’  for  parent 
Adding  category  ‘ ‘move_features’ ’ 

Using  ‘ ‘move.domain. concept ’ ’  for  parent 
Adding  category  ‘ ‘wm.move.components’ ’ 

Using  “move.domain.concept”  for  parent 
Adding  category  ‘ ‘wm_product .architecture” 

Using  ‘ ‘move_domain_ concept ’ ’  for  parent 
Adding  category  ‘‘Action  Type” 

Using  ‘‘Action  Definition’’  for  parent 
Adding  category  ‘‘Action’’ 

Using  ‘‘Action  Definition’’  for  parent 
Adding  relationship  ‘ ‘has_action_t3rpe”  to  ‘‘Action’’ 

Adding  category  ‘ ‘required.f eatures’ ’ 

Using  ‘ ‘move.features’ ’  for  parent 
Adding  category  ‘ ‘optional.f  eatures” 

Using  ‘ ‘move.features”  for  parent 
Adding  relationship  ‘ ‘optional.f eature”  to  ‘ ‘um_move_components’ ’ 
Adding  relationship  ‘ ‘required.feature”  to  ‘ ‘wm.move.components” 
Adding  category  ‘ ‘sunview.move” 

Using  ‘ ‘wm.move. components”  for  parent 
Adding  category  ‘‘xlO.move” 

Using  ‘ ‘wm_move_components’ ’  for  parent 
Adding  category  ‘ ‘wm_move_operation” 

Using  ‘ ‘wm_product_2u:chitecture”  for  parent 
Adding  category  ‘ ‘screen.layout.operation” 

Using  * ‘wm.product.architecture’ ’  for  parent 
Adding  category  ‘‘System  String” 

Using  ‘‘Action  Type”  for  parent 
Adding  category  ‘ ‘Display.Action” 

Using  ‘‘Action’’  for  peirent 
Restricting  value  of  relationship 
‘ ‘Display.Action’ ’ . ’ ’has.action.type’ ’ 

Adding  initial  empty  subset  for  ‘ ‘Display.Action”  .  ”heis_action_type” 
Adding  action  tuple  of  ‘‘Display”  to  ‘ ‘move.domain.concept’ ’ 

Adding  category  ‘ ‘Show.Feature” 

Using  ‘‘Action”  for  parent 

Restricting  value  of  relationship  ‘ ‘Show.Feature”  . ’ ’has_action_type’ ’ 
Adding  initial  empty  subset  for  ‘ ‘Show.Feature’ ’ . ’ ’has_action_type’ ’ 
Adding  category  ‘ ‘window.layout’ ’ 

Using  ‘ ‘required.f eatures’ ’  for  parent 
Adding  category  ‘ ‘move.input” 

Using  ‘ ‘required.features’ ’  for  parent 
Adding  object  ‘ ‘option. chosen” 
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Using  ‘ ‘optional.features’ ’  for  parent 
Adding  object  ‘ ‘abort _move_operation ’ ’ 

Using  ‘ ‘optional .features ’ ’  for  parent 
Adding  action  tuple  of  “Show”  to  “ abort .move.operat ion” 
Adding  object  ‘ ‘move. icon” 

Using  ‘ ‘optional. features”  for  parent 
Adding  action  tuple  of  “Show”  to  “move.icon” 

Adding  object  ‘ ‘peurtially.off .screen” 

Using  “optional.features”  for  parent 
Adding  action  tuple  of  ‘‘Show”  to  ‘ ‘partially.off. screen” 
Adding  category  “move.resize.feedback” 

Using  ‘‘optional.features”  for  parent 
Adding  ob j  ect  ‘ ‘ constrained.move ’ ’ 

Using  ‘‘optional.features”  for  parent 
Adding  action  tuple  of  ‘‘Show”  to  ‘‘constrained.move” 
Adding  category  ‘ ‘move.erasure” 

Using  “optional.features”  for  peirent 
Adding  relationship  ‘ ‘when.to. erase”  to  “move.erasure” 
Adding  object  “expose.af  ter  .move” 

Using  “optional.features”  for  parent 
Adding  action  tuple  of  “Show”  to  “expose.af  ter  .move” 
Adding  object  ‘ ‘sunview.move.description” 

Using  “sunview.move”  for  peurent 
Adding  object  “sunview_move_component” 

Using  “sunview.move”  for  parent 
Adding  object  ‘ ‘xlO.move.description” 

Using  “xlO.move”  for  peirent 
Adding  object  ‘ ‘xlO.move.component” 

Using  “xlO.move”  for  parent 
Adding  object  ‘ ‘overlapped.layout” 

Using  “window.layout”  for  parent 
Adding  category  “tiled.layout” 

Using  ‘‘window.layout”  for  parent 
Adding  object  ‘ ‘move.border” 

Using  ‘ ‘move.input”  for  parent 
Adding  object  ‘ ‘move.interior” 

Using  “move.input”  for  peurent 
Adding  object  ‘ ‘zap. effect” 

Using  ‘‘move.resize.feedback”  for  parent 
Adding  object  ‘ ‘window.configuration” 

Using  “move.resize.feedback”  for  parent 
Adding  category  “  interact ive.feedback” 

Using  “move.resize.feedback”  for  parent 
Adding  object  ‘ ‘erase.before” 

Using  ‘‘move.erasure”  for  parent 
Adding  object  “erase.after” 

Using  ‘‘move.erasure”  for  parent 
Adding  object  ‘ ‘tiled.layout.descr” 
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Using  ‘ ‘tiled.layout’ ’  for  pairent 
Adding  action  tuple  of  ‘‘Display’’  to  ‘ ‘tiled_layout_descr’ ’ 

Adding  object  ‘ ‘tiled.columns’ ’ 

Using  ‘ ‘tiled.layout  ’  ’  for  pao'ent 
Adding  object  ‘ ‘tiled.arbitrary ’ ’ 

Using  ‘ ‘tiled.layout’ ’  for  parent 
Adding  object  “ghost.f eedback’ ’ 

Using  ‘ ‘interactive.feedback’ ’  for  parent 
Adding  filler  ‘ ‘erase.after’ ’  to  ‘ ‘sunvieH_move_component’ ’ 

Adding  filler  ‘ ‘constrained.move* ’  to  ‘ ‘sunview_move_component” 
Adding  filler  ‘ ‘ghost .feedback ’ ’  to  ‘ ‘sunview_move_ component ’ ’ 

Adding  filler  ‘ ‘move.border’ ’  to  ‘ ‘sunvieu.move.component’ ’ 

Adding  filler  ‘ 'abort .move.operation’ ’  to  ‘ ‘sunview_move_component’ ’ 
Adding  filler  ‘ ‘move.icon’ ’  to  ‘ ‘ sunview_move_component ’ ’ 

Adding  filler  ‘ ‘ overlapped.layout ’ ’  to  ‘ ‘sunview_move_component’ ’ 
Adding  object  ‘ ‘opaque.f eedback’ ’ 

Using  ‘ ‘ interactive.f eedback’ ’  for  parent 
Adding  filler  ‘ ‘expose.after.move’ ’  to  “ xlO_move_ component ’ ’ 

Adding  filler  ‘ ‘erase.after’ ’  to  ‘ ‘xlO_move_component’ ’ 

Adding  filler  “window. configuration”  to  “xlO.move.component” 
Adding  filler  ‘ ‘zap. effect ’ ’  to  “xlO.move.component’’ 

Adding  filler  ‘ ‘opaque.f eedback’ ’  to  ‘ ‘xl0.move_component’ ’ 

Adding  filler  ‘ ‘ghost. feedback ’ ’  to  “xlO.move.component’’ 

Adding  filler  “move. interior”  to  “xlO.move.component” 

Adding  filler  ‘ ‘move. icon’ ’  to  ‘‘xlO.move.component’’ 

Adding  filler  ‘ ‘overlapped.layout’ ’  to  “xlO.move.component’’ 

Binding  model  attributes. 

Adding  file  attribute  ‘‘Help’’  to  ‘ ‘movo.domain. concept ’ ’ 

Adding  string  attribute  ‘ ‘Display.Action.String”  to 
‘ ‘Display. Action’ ’ 

Adding  string  attribute  ‘ ‘Show.Feature.String’ ’  to  ‘ ‘Show.Feature’ ’ 
Adding  file  attribute  ‘‘Contents’’  to  ‘ ‘tiled.layout.descr’ ’ 

Adding  file  attribute  “Feature. Attribute”  to 
‘ ‘ abort .move.operation’ ’ 

Adding  file  attribute  ‘ ‘Feature.Attribute’ ’  to  ‘ ‘move. icon’ ’ 

Adding  file  attribute  ‘‘Feature.Attribute”  to 
‘ ‘partially. off .screen’ ’ 

Adding  file  attribute  ‘‘Feature.Attribute”  to  ‘ ‘ constrained.move ’ ’ 
Adding  file  attribute  ‘‘Feature.Attribute’’  to  ‘ ‘expose. after .move’ ’ 
Attaching  inferencer  ‘ ‘move.domain. concept ’ ’  to 
‘ ‘move.domain.concept’ ’ 

Attaching  inferencer  ‘ ‘opt ion.move. res ize.f eedback”  to 
‘ ‘move.resize.f eedback’ ’ 

Attaching  inferencer  ‘ ‘xlO.uwm.move’ *  to  ‘‘xlO.move’’ 

Attaching  inferencer  ‘ ‘sun.view.move’ ’  to  “ sunview.move ’ ’ 
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Saving  library  model  to  disk. 
Library  model  created. 


Creating  Inferencer  from  move.domain.rbdl 
Parsing  input. 

Peirsing  completed  successfully. 

Entering  attribute  evaluation  phase. 

Exiting  attribute  evaluation  phase. 

Inferencer  ‘ ‘move_domain_concept’ ’  created. 

Creating  Inferencer  from  option_move_resize.rbdl 

Pearsing  input. 

Parsing  completed  successfully. 

Entering  attribute  evaluation  phase. 

Exiting  attribute  evaluation  phase. 

Inferencer  ‘ ‘option.move.resize.f eedback’ *  created. 

Creating  Inferencer  from  sunview.move.rbdl 

Parsing  input. 

Parsing  completed  successfully. 

Entering  attribute  evaluation  phase. 

Exiting  attribute  evaluation  phase. 

Inferencer  ‘ ‘sun.view.move’ ’  created. 

Creating  Inferencer  from  xlO_move.rbdl 

Parsing  input. 

Parsing  completed  successfully. 

Entering  attribute  evaluation  phase. 

Exiting  attribute  evaluation  phase. 

Inferencer  ‘ ‘xlO_uinn_move’ ’  created. 


After  successful  translation,  the  library  model  is  browsable  with  the  RLF  Graphical  Browser. 
To  verify  that  the  translation  was  successful,  try  to  browse  the  model  using  the  procedures 
described  in  the  previous  section. 
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A  Appendix:  Customization 

Since  the  RLF  GB  is  an  X  application,  users  are  able  to  customize  the  “look  and  feel’'  of  the 
application  to  a  significant  degree.  The  range  of  customization  possible  is  large,  therefore, 
only  the  subset  of  bitmap  and  font  customization  options  will  be  discussed  in  this  appendix. 
For  a  detailed  description  of  all  the  possible  X  customization  procedures,  see  the  X  references 
listed  in  Appendix  D,  “References.” 


A.l  X  Resources 

All  X  applications  have  resources.  These  resources  consist  of  items  such  as  bitmaps,  fonts, 
colors,  cursors,  and  windows.  All  these  resources  have  unique  identifiers  associated  with 
them  for  naming  purposes;  thus,  the  user  or  application  programmer  can  set  the  values  of 
these  resources  to  customize  the  look  and  feel  of  applications. 

There  is  a  set  of  precedence  rules  that  all  X  applications  follow  to  determine  what  resources 
will  be  applied  to  a  given  invocation  of  the  application.  Resources  that  are  loaded  first  will 
be  overridden  by  those  loaded  later. 

The  following  list  states  the  rules  for  setting  X  application  resources  in  reverse  order  of 
priority.  For  example,  item  1  will  be  overridden  by  item  4,  and  item  4  will  be  overridden  by 
item  5. 


1 .  / usr/lib/X  1 1  / app-defaults/ Application.  Class.Name 

•  the  application  resource  specification  file  on  the  host  running  the  client  X  appli¬ 
cation 

•  this  corresponds  to  the  /usr/lib/Xll/app-defaults/RLF_Browser  file  for  the 
RLF  GB  application 

2.  XAPPLRESDIR  environment  variable 

•  the  value  of  the  XAPPLRESDIR  environment  variable  is  a  directory  pathname;  it 
can  be  set  to  point  to  a  directory  containing  a  file  named  Application.Class.Name, 
e.g.,  RLF_Browser,  that  resides  somewhere  other  than  /usr/lib/Xll/app-def  aults 

3.  Resources  loaded  into  the  RESOURCE-MANAGER  property  of  the  root  window 

•  typically,  the  user  arranges  to  have  xrdb  run  from  the  X  initialization  file 
.xinitrc 

•  if  the  RESOURCE-MANAGER  property  is  not  set,  the  resource  manager  looks 
for  a  .Xdef aults  file  in  the  user’s  home  directory 

4.  XENVIRONMENT  environment  variable 
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•  a  complete  pathname  including  the  filename  (different  from  the  XAPPLRES- 
DIR  environment  variable,  which  is  only  the  pathname,  but  does  not  include  the 
filename) 

•  if  this  variable  is  not  defined,  then  the  resource  manager  looks  for  a  file  in  the 
user’s  home  directory  named  .Xdef  aults-Aosiname 

5.  Command  Line  Values 

•  specified  with  the  -xrm  option  on  the  command  line 

•  values  are  loaded  for  that  instance  of  the  program  only 

6.  If  the  application  has  defined  any  command  line  options  by  passing  an  options  table 
to  the  programmatic  X  call  Xtinitialize,  values  from  the  command  line  will  override 
those  specified  by  any  other  resource  settings. 


A  default  application  resource  specification  file  called  RLF_BrowsGr  should  exist  in 
/usr/lib/Xll/app-defaults  as  a  result  of  the  installation  procedures  described  in  this 
document.  If  not,  users  should  contact  the  person  who  installed  RLF  (e.g.  the  site’s  system 
administrator)  to  determine  where  the  file  was  installed.  If  nothing  else  is  done,  the  RLF 
GB  will  use  the  resource  values  in  that  file. 

The  most  convenient  means  of  customizing  he  RLF  GB  is  to  make  your  own  copy  of  the 
RLFJrowser  file  and  set  XAPPLRESDIR  to  point  to  its  directory  location.  Then  you  can 
edit  the  RLF_Browser  file  and  change  any  resources  specified  in  that  file,  such  as  bitmaps, 
fonts,  window  sizes  and  window  placement  to  suit  individual  needs. 
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A. 2  Bitmaps 

The  RLF  GB,  Version  4.1,  uses  the  Motif  widget  set,  therefore.  Motif  configuration  standards 
and  conventions  must  be  used.  This  has  a  significant  impact  on  how  resources  are  set, 
particularly  in  relation  to  earlier  versions  of  the  RLF  GB.  The  result  is  that  most  of  the 
methods  for  setting  resources  are  different  from  pre-4.1  versions. 

The  pathname  to  the  bitmaps  directory  is  no  longer  specified  in  the  old  Browser  file,  or  the 
new  RLF -Browser  file.  In  Motif  applications,  the  bitmaps  directory  must  be  a  subdirectory 
in  the  resource  file’s  pathname.  For  example  if  you  set  the  XAPPLRESDIR  environment 
variable  to  /usr/lib/Xll/rlfgb,  then  the  RLF  GB  looks  for  the  bitmaps  directory  to  be  at 
/usr/lib/Xll/rlfgb/bitmaps.  This  directory  must  contain  the  bitmaps  used  by  the  RLF 
GB. 

You  can  change  XAPPLRESDIR  to  point  to  a  different  directory,  and  therefore  a  different 
bitmaps  directory,  to  use  bitmap  files  that  you  have  created  or  customized.  If  the  pathname 
is  not  specified  correctly,  the  RLF  GB  will  not  be  able  to  find  its  bitmaps,  and  blank  space  will 
be  displayed  instead.  It  is  important  that  the  resource  file’s  directory  pathname  be  specified 
correctly  and  for  the  bitmaps  directory  to  be  located  in  that  directory  as  a  subdirectory  or 
else  the  RLF  GB  graphic  display  will  be  aesthetically  less  pleasing.  The  bitmaps  directory 
included  in  the  RLF  release  may  be  used  directly  unless  use  of  alternative  bitmaps  is  desired, 
in  which  case  you  may  create  a  bitmaps  directory  in  the  location  of  your  choice,  containing 
the  desired  bitmaps. 

The  specific  bitmaps  used  'oy  the  RLF  GB  to  represent  displayed  objects  can  be  specified 
in  the  RLF_Browser  file.  The  different  types  of  nodes  in  an  RLF  GB  graph  view  each  have 
a  bitmap  defined  for  it.  For  example,  all  category  nodes  that  do  not  have  any  actions  or 
inferencers  attached  use  the  bitmap  file  specified  by  the  following  line  in  the  RLF_Browser 
file: 


vshell*scr_window*node_CATEGORY_KIND .  labelPixmap :  box_m .  xbm 

while  all  object  nodes  that  do  not  have  any  actions  or  inferencers  attached  use  the  bitmap 
file  specified  by  the  following  line  in  the  RLF_Browser  file: 


vshell*scr_window*nodeJ3B  JECT-KIND .  labelPixmap :  cube  jm .  xbm 


All  category  nodes  could  be  changed  to  display  a  different  bitmap  by  editing  the  above  line 
in  the  RLF_Browser  file  and  specifying  a  different  value  for  the  bitmap  file.  For  example,  to 
change  the  category  nodes  to  a  bitmap  you  created  and  placed  in  a  file  called  my_bitmap  .xbm, 
you  would  set  the  value  in  the  RLF -Browser  resource  file  to  the  following: 


vshell*scr-window*ixode-CATEGORY_KIND  .  labelPixmap ;  my -bitmap .  xbm 
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Alternatively,  you  may  specify  an  absolute  pathname  for  any  particular  bitmap.  For  example, 
you  could  use  bitmap  files  from  your  home  directory,  as  in  the  following  example: 


vshell*scr_window*node_CATEGORY_KIND .  labelPixmap :  /home/my  _name/my  .bitmap .  xbm 


A. 3  Fonts 

Fonts  used  by  the  RLF  GB  application  can  be  changed  in  the  same  manner  as  bitmaps. 
There  are  lines  in  the  RLF  .Browser  file  that  specify  what  fonts  to  use  for  particular  textual 
objects  in  the  RLF  GB  display.  For  example,  the  font  used  for  Category  concept  names  in 
the  graph  display  is  specified  in  the  following  line  in  the  RLF.Browser  file; 


V8hell*8cr.vindov*no<le«lab6l.CATEG0RY.KIID*fontLi8t :  -bAh-lucida-bold-i-^-^-17-*-*-*-*-*-*-* 


and  similarly,  this  font  name  could  be  modified  to  suit  varying  needs.  For  instance,  the 
display  of  very  large  graphs  sometimes  necessitates  the  use  of  a  smaller  font  (and/or  smaller 
bitmaps)  so  that  the  graph  display  will  not  exceed  the  capacity  of  X  to  display  it.  Or 
sometimes  very  large  fonts  and  bitmaps  are  desired  for  demonstration  purposes.  These 
types  of  customizations  and  many  others  are  most  easily  accomplished  by  modifying  the 
RLF  browser  file  and  setting  the  XAPPLRESDIR  environment  variable  appropriately. 


A. 4  Invoking  the  Browser  from  a  Shell  Script 

The  C  shell  script  RLF.GB  checks  the  appropriate  environment  variables  to  determine  as 
best  it  can  whether  they  are  valid,  and  then  invokes  the  RLF  Graphical  Browser.  This 
method  of  invocation  is  recommended  for  novice  and  beginning  RLF  users.  The  RLF.GB 
script  is  found  in  the  unix/bin  or  pcte/bin  directory  of  this  software  release,  along  with 
the  GraphicaUrowser  executable. 


A. 5  Command  Line  Arguments 

Another  way  of  customizing  the  look  of  the  RLF  GB  is  to  set  X  resources  via  the  command 
line.  Various  X  resources  can  be  specified  by  invoking  the  X  application  with  the  appropriate 
command  line  arguments.  As  car  be  seen  in  the  list  of  precedence  rules,  this  method  will 
override  any  other  previous  settings. 

An  example  of  invoking  the  RLF  GB  with  command  line  arguments  is  as  follows: 

For  an  extra-large  library,  use  a  small  font  and  small  bitmaps: 
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Qraphical.BroBsar  \ 

-xna  "vshall*scr_Bin<loB*node_label_CATEGORy_KIID*foiitList :  \ 

-xrai  "vshell*scr_sindoB*node_label,CATEGORY_W_ACTIOI*f ontList :  -bAh-*-*-r-*-«-10-*-*-*-»-*-»-»"  \ 

-xrai  ''vshall*scr_BindoB*node_label_CATEQORY_U_ADVICE*f ontList :  -bAh-»-*-r-*-*-10-*-*-*-*-*-*-»"  \ 

-xna  ''vshell*scr_BindoB*node_label_CATEGORY_U_AI>VICE_AID_ACTIOI*fontList :  -bAh-*-*-r-*-*-10-*-*-*-»-»-»-»"  \ 
-xiBi  "vshell*scr_BindoB*node_label.OBJECT_KIID*f ontList :  \ 

-xna  "vshall*scr_BindoB*node_label_OBJECT_U_ACTIOI*fontList:  -bAh-*-*-r-*-*-10-*-»-*-*-*-*-*"  \ 

-xrai  "vshall*scr_BindoB*node_label_OBJECT_W_AOVICE*fontList:  -bAh-»-»-r-*-«-10-*-*-*-»-*-*-*‘'  \ 

-xna  "V8hall*BCC_BindoB*nod«_labal_0BJECT_U_A0VICE_AlD_ACTI0l*f ontList ;  \ 

-xrai  "vshell*scr_BindoB*node_CATEGORY_KIID.labelPixBap;  box.xs . xbai"  \ 

-xna  "vshell«scr.BindoB*noda_CATEGORY_KIID.reversaLab«lPixmp:  box.rav.xs.xba"  \ 

-xna  "vshell*8cr.BindoB*node_CATEG0RY.W_ACT10l.labalPixa»p;  box.A.xs . xbai"  \ 

-xna  “vshell*scr_BindoB*noda_CATEGORY_W_ACTIOI.ravers«LabalPixaiap;  box.A.rav.xs .xba"  \ 

-xna  "vshall*Bcr_BindoB*noda_CATEGORY_U_ADVICE.lab«lPixawp;  box_I_xs .xbai"  \ 

-xna  "V8hell*Bcr_BindoB*node_CATEG0RY_W_ADVICE.ravarseLabalPixaiap:  box_I_rev_xs.xbai“  \ 

-xna  "vshell*scr_BindoB*node_CATEGORY_U_ADVICE_AID_ACTIQI.labelPixaMp;  box.AI.xs .xbai"  \ 

-xrai  "V8hell*8cr_BindoB*noda_CATEG0RY_U_ADVICE_AID_ACTI0I.ravarseLabelPixa^:  box_AI_rav_x8 .xbai"  \ 

-xna  "v8hall*8cr_BindoB*node_0BJECT_KIII>.labelPixBwp;  cuba.xs . xbai"  \ 

-xrai  "v8halla8cr_BindoBanode_0BJECT_KIID.ravar8aLabelPixaap:  cuba_rav_x8 .xba"  \ 

-xna  "V8hallascr.BindOBanoda_0BJECT_W_ACTI0l.labalPlxfliap:  ciiba_A_X8 . xbai"  \ 

-xna  "V8hallaacr_BiiidoBanoda.aBJECT_U_ACTI0l.ravaraaLabalPixBap:  cuba.A_rav_x8.xlxa"  \ 

-xna  “v8halla8cr_aindoBanoda_0BJECT_U_ADVICE.lab8lPixaiap:  cube_I_x8.xbai"  \ 

-xna  "vahallascr_BindaBanoda_OBJECT_W_AOVlCE.ravarsaLabalPixaMp:  cab8_I_rav_x8.xbai”  \ 

-xna  "v8halla8cr.BindoBanoda_0BJECT_H_A0VICE_AID_ACTI0l.labalPixaiap;  cuba.AI.xs .xbai"  \ 

-xna  "V8hallascr_BindoBanoda_0BJECT_W_ADVICE_AID_ACTI0I.raT8rsaLab8lPixBap:  cuba_Al_rav_xs .xbai" 


For  a  demonstration,  you  might  want  to  use  a  large  font  and  large  bitmaps: 


Graphical.Broaser  \ 

-xm  "vahallascr.BindoBanoda.labal.CATEGORY.EIIDafontList:  -b*h-a-*-r-a-a-20-a-a-a-a-a-a-a"  \ 

-xiBi  "vshallascr.BindoBanoda.labal.CATEGORY.H.ACTIOIaf ontList :  -b*h-*-a-r-*-a-20-*-*-»-*-*-a-»”  \ 

-xrai  "vahallascr.sindoBanoda.labal.CATEOORY.U.ADVICEaf ontList :  -bth-*-*-r-*-*-20-a-a-a-a-a-a-a"  \ 

-xna  "vsh8lla8cr_BindoB*tioda_labal_CATEG0RY.U_AI)VICE.AID_ACTIDI*f ontList :  -b»h-a-a-r-*-a-20-*-*-*-a-a-a-a"  \ 
-xr»  "V8hall*scr_BindoBanoda.labal_0BJECT_Ein>af ontList :  -b*h-a-a-r-a-a-20-a-a-a-a-a-a-a"  \ 

-xna  "Tshallascr.BindoBanode.labal.OBJECT.U.ACTIOIafontList :  -b*h-a-a-r-a-a-20-a-a-a-a-a-a-a"  \ 

-xna  "vshallascr.BindoBanoda.labal.OBJECT.H.ADVICEafontList :  -b*h-a-a-r-a-a-20-a-a-a-a-a-a-a"  \ 

-xna  "vshalla8cr.BindoBanoda_labal_0BJECT_ll_ADVICE_An)_ACTI0l*f ontLixt :  -b*h-a-a-r-a-*-20-a-a-a-a-a-a-a"  \ 
-xna  “vshallascr.BindoBanoda.CATEGORY.KIID.labalPixaiap:  box_ai . xbai"  \ 

-xna  "vshallascr.BindoBanoda.CATEGORY.EIID.ravarsaLabalPixawp:  box.rav.a.xbai"  \ 

-xna  "v8hell*scr.BindoB*noda_CATEQ0Rr_U_ACTI0l.labalPixaMp;  box. A.ai . xbai”  \ 

-xna  "v8hall*scr_BindaB*iiode_CATEG0RY_W_ACTI0l.raTarsaLabalPixBi4>:  box.A.rav.B.xbai"  \ 

-xna  "v8hall*scr_BindaB*nod«_CATEG0RY_W_ADVICE.IabalPixBap;  box.I.a.xbai"  \ 

-xna  "vshall*scr_BindoB*noda_CATEaORY_U_ADVICE.ravors«LabolPixaiap:  box.I.rav.ai.xbai”  \ 

-xna  "v8hall*scr_BindoB*noda_CATEa0RY_W_ADVICE_AID_ACTI0l.labalPixaMp:  box. Al.ai. xbai"  \ 

-xrai  "vshall«8cr.Bindo8*nada.CATE00RY.H.ADVICE_AID.ACTI0l.ravor8aLabalPix»^:  box_AI_rav.Bi.xbai"  \ 

-xna  "vshalla8cr_BindoB*iioda_0BJECT_KIID.labalPixaup:  caba_a.xbai"  \ 

-xrai  "vshollascr.BindoBanoda.OBJECT.EIID.ravaraaLabalPixaap:  cube.rev.ai.xbai"  \ 

-xna  "VBhallascr.BindoBanodo.OBJECT.U.ACTIOl.labolPixaap:  cube. A.ai. xbai"  \ 

-xna  "vahollaacr.BindoBanoda.OBJECT.W.ACTIOI.ravarsoLabolPixaMp:  cuba.A.rav.ai.xbBi"  \ 

-xrai  "vahallascr.BindoBanoda.OBJECT.W.ADVICE.labolPixaiap;  cuba.I.B.xba"  \ 

-xna  "vshallascr.BindoBanode.OBJECT.H.ADVICE.ravarseLabalPixBap:  cuba_I_rev_ai.xbBi"  \ 

-xna  "vshallaacr.Bindoaanoda.OBJECT.H.AOVICE.AIO.ACTIOl.labalPixaiap:  cnba.AI.ai.xbai"  \ 

-xna  "v8hallascr_BindoBanoda_0BJECT_H_A::VICE_An>_ACTI0l.ravarsaLab8lPixaiap:  cube. AI.rav.ai. xbai" 


The  above  command- line  invocations  of  the  RLF  GB  with  command  line  arguments  specify 
the  font  and  bitmaps  of  the  graph  view  window  that  is  displayed.  These  command  line 
arguments  override  any  other  resource  settings  that  may  been  specified  previously.  Editing 
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startup  scripts  like  these,  or  typing  new  command  line  arguments  manually,  are  more  exam¬ 
ples  of  the  many  options  available  for  customizing  X  applications  such  as  the  RLF  GB.  Other 
X  resource  customizations,  such  as  window  size  and  placement,  can  also  be  accomplished 
using  the  command  line  argument  method. 

For  further  possibilities  of  customizing  X  resources,  consult  the  X  Window  System  reference 
given  in  Appendix  D,  References. 
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B  Appendix:  PCTE 

In  most  respects,  the  PCTE  version  of  this  delivery  of  RLE  operates  in  the  same  manner  as 
the  UNIX  version.  However,  there  are  differences,  and  this  appendix  presents  the  differences 
in  the  PCTE  and  UNIX  versions  of  RLE  and  some  conventions  which  can  be  used  to  increase 
portability  between  versions.  This  appendix  assumes  knowledge  of  PCTE,  the  Emeraude 
PCTE  product,  and  the  esh  encapsulated  shell.  A  major  assumption  for  this  release  of  the 
PCTE  RLE  is  that  you  install  the  software  into  UNIX,  then  run  esh  scripts  in  PCTE  to 
install  RLE  libraries  into  the  PCTE  object  base,  then  run  the  RLE  GB  from  UNIX  (since  it’s 
not  encapsulated  -  you  just  use  the  absolute  pathname),  and  the  PCTE  version  of  the  RLE 
GB  then  accesses  the  objects  in  the  PCTE  object  base.  Eor  a  more  detailed  discussion  of 
library  modeling  issues  with  the  PCTE  version  of  the  RLE,  see  the  RLF  Modeler’s  Manual. 


B.l  Installing  the  PCTE  Version  of  RLF 

The  installation  procedures  for  the  PCTE  version  of  RLE  are  similar  to  the  installation 
procedures  for  the  UNIX  version  of  RLE.  Some  of  the  differences  have  been  noted  in  the 
preceding  sections  of  this  manual,  and  some  of  the  differences  are  obvious.  Eor  example,  the 
interactive  installation  scriptInstallJlLF_pcte_bin  is  used  instead  of  Install_RLF_bin. 

The  PCTE  installation  proceeds  the  same  as  the  UNIX  installation,  except  no  RLE  libraries 
are  automatically  created  for  the  PCTE  version.  You  must  start  esh  (encapsulated  shell) 
scripts  from  inside  the  PCT  5  environment  to  create  RLE  libraries  in  the  PCTE  object  bcise. 
The  procedures  for  running  these  scripts  are  provided  in  the  next  section. 


B.2  Verifying  the  PCTE  RLF  Installation 

The  procedures  for  verifying  the  PCTE  RLF  installation  are  similar  to  the  UNIX  version, 
but  differ  because  they  ultimately  must  be  performed  from  within  the  PCTE  environment. 

After  the  installation  of  the  PCTE  RLF  system  has  completed,  you  should  be  able  to  de¬ 
termine  that  the  pcte/bin  subdirectory  of  the  RLFHOME  directory  contains  the  following 
executable  programs  by  issuing  an  Is  command: 


Is  -a  $RLFHOME/pct e/bin 


The  Is  -a  command  should  produce  results  similar  to  the  following: 


.rlfrc 

GraphicaUrowser 

Library-Manager 

Lmdl 
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RLF_Browser 

RLF.GB 

Rbdl 

bitmaps  (a  directory) 
pete .prof ile 
pcte_install 


B.2.1  Starting  the  X  Window  System 

An  X  server  must  be  running  on  your  local  workstation  for  the  RLF  GB  to  be  successfully 
invoked.  However,  it  is  beyond  the  scope  of  this  installation  guide  to  describe  how  to  install 
X,  or  how  to  start  the  X  server  on  a  workstation.  Consult  your  local  system  administrator 
for  help. 


B.2.2  Installing  the  esh  Init  File 

Before  invoking  the  RLF  GB,  you  may  first  want  to  install  the  .profile  file  into  the  PCTE 
object  base.  The  .profile  is  an  initialization  file  that  is  read  by  the  esh  when  it  is  invoked. 
This  step  is  optional;  the  .profile  file  is  used  for  convenience — it  gathers  frequently  used 
commands  into  a  file  and  performs  those  commands  automatically  upon  shell  invocation. 

The  .profile  file  supplied  with  this  release  contains  the  necessary  commands  to  set  the 
appropriate  environment  variables.  However,  the  pathnames  provided  should  be  tailored  for 
your  site  by  editing  the  .profile  file  with  the  text  editor  of  your  choice; 


editor  $RLFHOME/pcte/bin/pcte. prof  ile 


The  .profile  file  in  the  current  release  looks  similar  to  the  following;  note  that  the  esh  is 
an  encapsulation  of  the  Bourne  shell  (s/i),  and  therefore  uses  Bourne  shell  syntax; 

XAPPLRESDIR=$RLFHOME/pcte/bin;  export  XAPPLRESDIR 
PATH*"/rlf. tools :$PATH;  export  PATH 
RLF .LIBRARIES*" /Instances4.e;  export  RLF.LIBRARIES 
RLF_PAGER®/usr/local/bin/less;  export  RLF.PAGER 


If  any  of  the  above  pathnames  are  not  appropriate  for  your  site,  then  change  them  to  reflect 
more  suitable  values.  There  are  two  environment  variables  that  must  be  set  before  the  RLF 
GB  can  be  run  successfully.  They  are  as  follows; 

•  DISPLAY 
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You  can  edit  the  .profile  file  so  that  these  variahles  are  autoaiutieally  set  every  lime  you 
invoke  a  new  esh  shell.  The  DISPLAY  variable  is  not  set  in  the  above  sample  .profile  file, 
but  it  could  be  set  there  if  desired.  Note  that  environment  variables  are  inherited  by  the  esh 
from  its  parent  process. 

The  XAPPLRESDIR  environment  variable  contains  the  location  of  the  RLF_Browser  X  re¬ 
source  file.  The  bitmaps  directory  should  exist  as  a  subdirectory  to  this  location. 

The  RLF_PAGER  environment  variable  must  be  set  to  the  pathname  of  a  text  pager.  This 
is  the  text  pager  that  the  RLF  GB  will  invoke  inside  an  xterm  window  to  display  text. 

The  RLF-LIBRARIES  environment  variable  is  used  by  the  RLF  to  determine  the  location 
of  the  RLF  libraries  to  be  read.  An  RLF  library  must  be  created  before  the  RLF  GB  can 
be  used  to  browse  that  library. 


B.2.3  Starting  the  PCTE  Server 

Consult  the  Emeraude  V12  System  Administration  Guide  for  information  on  how  to  start 
the  PCTE  server. 


B.2.4  Logging  into  PCTE 

The  “standard”  method  for  logging  into  PCTE  is  sufficient  for  using  the  RLF  GB.  Consult 
the  Emeraude  V12  System  Administration  guide  for  details. 

Before  logging  in  to  PCTE,  set  the  RLFHOME  environment  variable,  if  it  hasn’t  already 
been  set.  The  value  of  the  RLFHOME  environment  variable  should  be  the  same  as  that  set 
in  the  BuildJlLF .  var  file.  The  pathname  is  probably  the  same  as  the  location  where  the 
release  weis  extracted  from  the  transfer  media. 

The  RLFHOME  environment  variable  is  used  for  convenience;  you  could  type  the  entire 
absolute  pathname  instead,  but  that  can  be  cumbersome. 


setenv  RLFHOME  pathname 


Assuming  your  command  search  path  is  set  properly  to  find  the  Emeraude  PCTE  commands, 
and  assuming  you  have  been  set  up  as  valid  PCTE  user,  you  should  be  able  to  issue  the  log 
command  as  follows: 
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This  should  invoke  an  esh  shell  with  a  prompt  similar  to  the  following: 


esh$ 


B.2.5  Creating  RLF  Libraries  in  the  PCTE  Object  Base 

After  the  .profile  file  has  been  tailored  to  your  satisfaction  it  must  be  installed  in  the 
PCTE  object  base  before  it  can  have  any  efFfect.  The  UNIX  file  is  copied  into  the  object  base 
with  the  PCTE  object.copy  command  as  in  the  following  example: 


esh$ 


obj_copy  -c  $RLFHOME/pcte/bin/pcte. profile  $PCTE_HDME/ .prof ile 


Before  the  RLF  GB  can  be  successfully  invoked  in  tliv  PCTE  environment,  an  RLF  library 
must  be  installed  into  a  PCTE  object  base.  To  accomplish  this,  the  following  procedures 
may  be  used. 

Any  of  the  esh  scripts  in  the  models  subdirectory  of  the  RLF  release  may  be  used  to  create 
the  associated  RLF  library  in  the  PCTE  object  base.  The  following  examples  show  the 
creation  of  the  “Animals”  RLF  library. 

Invoke  the  esh  script  using  the  full  UNIX  pathname  to  the  script,  with  an  argument  of  the 
pathname  to  the  RLFHOME  location: 


esh$ 


$RLFHOME/models/animals/Buil(LAnimals-Lib .  esh  $RLFH0HE 


The  script  Build-Animals_Lib.esh  copies  the  necessary  files  from  UNIX  into  the  PCTE 
object  base  and  executes  the  Lmdl  translator  on  the  LMDL  script. 


B.2.6  Installing  the  RLF  Tools  into  the  PCTE  Object  Base  (Optional) 

You  may  want  to  install  the  RLF  tools  into  your  PCTE  object  bcise  instead  of  invoking  them 
from  UNIX.  This  is  completely  optional.  This  section  may  be  ignored  if  you  do  not  want 
to  do  this,  since  the  tools  can  be  successfully  invoked  from  UNIX.  However,  if  you  do  want 
to  install  the  RLF  tools  into  the  object  base,  then  follow  the  procedures  described  in  this 
section. 

There  is  a  script  called  $RLFHOME/pcte/bin/pcte_install  that  installs  an  rlf  .tools  toolset 
directory  in  the  location  specified  by  $PCTE_H0ME.  You  may  not  be  able  to  create  toolset  ob¬ 
jects  everywhere,  but  you  should  be  able  to  install  it  in  the  PCTE  home  directory,  which  is 
the  default.  Pass  the  UNIX  path  of  the  location  where  the  RLF  release  was  extracted  from 
the  archive  media  (usually  this  is  also  specified  by  $RLFH0ME)  as  a  parameter  to  this  script: 
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OPTIONAL: 


esh$ 


$RLFHOME/pcte/bin/pcte_install  $RLFH0ME 


B.2.7  Invoking  the  PCTE  RLF  Graphical  Browser 

After  an  RLF  library  has  been  installed  in  the  PCTE  object  base,  the  RLF  Graphical_Browser 
may  be  invoked.  To  invoke  the  RLF  GB  from  within  the  PCTE  environment,  use  the  full 
UNIX  pathname  as  in  the  following  example: 


esh$ 


$RLFHOME/pcte/bin/Graphical_Browser 


B.3  File  Naming  Restrictions 

The  Emeraude  implementation  of  PCTE  places  restrictions  on  the  length  of  object  names  and 
makes  assumptions  about  the  use  of  in  object  names.  The  names  of  files  containing  assets 
which  are  available  in  an  RLF  reuse  library  are  restricted  to  32  characters  in  length  when 
using  PCTE.  These  are  the  files  that  reside  beneath  the  Text  sub  directory  of  any  directory 
where  RLF  libraries  have  been  constructed.  Additionally,  the  names  of  files  containing 
reusable  assets  in  the  library  should  not  contain  the  character,  since  this  indicates  a 
special  meaning  to  the  Emeraude  implementation  of  PCTE.  The  convention  established  by 
this  version  of  RLF  for  PCTE  is  to  replace  any  characters  in  file  names  with  the  underscore 
character,  An  exception  to  this  convention  is  the  .rlfrc  start-up  file,  which  the  PCTE 
version  of  RLF  will  look  for  as  an  entity  named  rlfrc .  e. 

To  increase  the  similarity  in  the  way  libraries  are  represented  in  the  UNIX  and  PCTE  versions, 
and  to  ease  transition  between  versions,  the  preferred  link  type  of  every  object  in  or  beneath 
the  directory  object  where  the  library  was  built  must  be  set  to  “.e”.  This  includes  files 
representing  a  library’s  assets  and  any  action  scripts  which  might  appear  below  the  Text 
directory.  The  preferred  link  type  of  the  directory  object  indicated  by  the  environment 
variable,  RLF_LIBRARIES,  also  needs  to  be  “.e”  so  that  its  subdirectories  can  be  traversed 
easily. 

Library  representations  built  with  the  PCTE  version  of  RLF  also  require  a  directory  object 
named  rlf.tools  to  be  a  first-level  subdirectory  of  the  directory  object  where  the  library 
is  built.  This  directory  object  must  also  contain  two  tools  named  ascii_f ile .tool  and 
displ_attr .tool.  These  tools  are  required  for  RLF’s  default  actions  to  operate  correctly. 

For  examples  of  library  model  construction  for  the  PCTE  version  of  RLF,  examine  the 
“ .  esh”  versions  of  the  build  scripts  for  the  example  libraries  delivered  with  the  RLF.  These 
scripts  are  found  in  each  subdirectory  of  the  models  subdirectory  of  an  RLF  installation. 
These  scripts  can  be  modified  and  reused  to  help  automate  the  procedures  required  to  build 
an  RLF  reuse  library  with  the  PCTE  version. 
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C  Appendix:  Reporting  Problems 

Like  most  software,  especially  that  of  a  prototypical  nature,  the  RLF  GB  may  contain  un¬ 
known  bugs  (along  with  some  known  bugs).  If  you  encounter  any  problems  with  this  software, 
or  have  any  suggestions  for  enhancements,  you  are  encouraged  to  report  them  to  STARS 
personnel.  The  Version  Description  Document  included  with  this  release  provides  instruc¬ 
tions  for  doing  this,  including  information  on  available  Internet  electronic  mail  addresses. 
Also  included  in  the  distribution  is  a  problem  report  form  for  formally  submitting  problem 
reports. 
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D  Appendix:  References 

This  sectio"  1is*s  a  number  of  resources  that  are  available  for  further  information.  The 
topics  are  relevant  to  the  use  of  the  RLF  GB  and  include  the  RLF,  the  RGB.  the  X  Window- 
System,  Ada,  and  PCTE  references. 

For  more  detailed  information  on  the  RLF,  see  the  following  documents; 

A  •  RLF  Binary  Release  Installation  Guide,  Version  4-L  STARS-UC-05156/012/00; 
March,  1993. 

A  •  RLF  User’s  Manual,  Version  4-L  STARS-UC/05156/013/00);  March,  1993. 

A  •  RLF  Administrator’s  Manual,  Version  STARS-UC-05156/017/00;  March,  1993. 

A  •  RLF  Modeler’s  Manual,  Version  STARS-UC-05156/01 1/00;  March,  1993. 

A  • 

RLF  Binary  Release  Version  Description  Document,  Version  4-U  STARS-UC- 
05156/016/00;  March,  1993. 

A  •  RLF  User  Tutorial,  Version  4-U  STARS-UC-05156/018/00;  March,  1993. 

A  •  RLF  Administrator  Tutorial,  Version  STARS-UC-05156/019/00;  March,  1993. 

A  •  RLF  Modeler  Tutorial,  Version  4.1,  STARS-UC-05156/020/00;  March,  1993. 

For  more  detailed  information  on  the  RGB,  see  the  following  documents: 

•  RGB  1.0  Version  Description  Document  (VDD),  STARS-US-020401/001/00 

•  RGB  1.0  User’s  Manual,  STARS-US-020401/002/00 

For  more  detailed  information  on  using  X  and  the  twm  window  manager,  see  the  following 
book: 


•  X  Window  System  User’s  Guide  for  XI 1  R3  and  R4,  Third  Edition;  Quercia,  Valerie, 
and  O’Reilly,  Tim;  O’Reilly  &  Associates,  Inc.;  Sebtistapol,  CA;  95472;  May  1990. 


For  more  detailed  information  on  SA-Motif  see  the  following  documents: 

•  Ada/Motif  Release  1.1,  The  Complete  Ada  Binding  for  X11R4  and  OSF/Motif  1.1, 
Users  Manual,  Systems  Engineering  Research  Corporation  (SERC),  Mountain  View, 
CA;  Sept.  28,  1992. 
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^  For  more  detailed  information  on  Sun  Ada  see  the  following  documents: 

•  Sun  Ada  User’s  Guide,  March,  1992 

•  SPARCworks/ Ada  User’s  Guide,  March,  1992 

For  more  detailed  information  on  Emeraude  PCTE  see  the  following  documents: 

•  The  Emeraude  Environment,  GIE  Emeraude,  1992;  PC6A1,  68,  route  de  Versailles, 
788430  Louveciennnes,  FRANCE. 
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